home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 2001 October / macformat-108.iso / Shareware / Developer tools / 24U Appearance OSAX 1.2 / README < prev    next >
Encoding:
Text File  |  2001-08-04  |  5.4 KB  |  118 lines  |  [ttro/ttxt]

  1.  
  2.  
  3.  
  4.  
  5.  
  6. 24U Appearance OSAX 1.2
  7.  
  8. This ReadMe file contains some iportant information about 24U Appearance OSAX, such as system requirements, installation guide, quick start, troubleshooting, licence notice, contact information, and copyright statement.
  9.  
  10.  
  11. 1. Introduction
  12.  
  13. 24U Appearance OSAX is so called Scripting Addition. It extends AppleScript™ by a few very easy-to-use commands to post notifications, display enhanced Appearance alerts, floating message windows, floating progress indicators, and even better dialogs such as this one:
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34. 2. System Requirements 
  35.  
  36. Minimum requirements:
  37.  
  38.    - Macintosh with 68020 processor
  39.    - Mac OS 7.5 with Appearance installed
  40.    - Mac OS 8.6 and AppleScript 1.3.7 for floating message windows and progress indicators
  41.  
  42. Recommended configuration:
  43.  
  44.    - Any Power Macintosh, PowerPC equipped PowerBook, iMac, or iBook
  45.    - Mac OS 8.6 or newer, AppleScript 1.3.7 or newer, Appearance 1.1 or newer
  46.  
  47.  
  48. 3. Installation 
  49.  
  50. To install 24U Appearance OSAX, follow these easy steps:
  51.  
  52.    1. If you did not do this yet, please download and expand the 24U Appearance OSAX archive.
  53.    2. Open the expanded 24U Appearance OSAX folder.
  54.    3. Remove any previous version of Appearance OSAX from your “Scripting Additions” folder.
  55.    4. Copy the “24U Appearance OSAX” icon into your “Scripting Additions” folder.
  56.        You can also drop the “24U Appearance OSAX” icon on your closed System Folder icon.
  57.    5. If you are going to use floating windows, copy the “TSM Fix 1.0.3” extension icon into your Extensions folder.
  58.        You can also drop the “TSM Fix 1.0.3” icon on your closed System Folder icon.
  59.    6. If you have installed also the “TSM Fix 1.0.3” extension, restart your computer.
  60.  
  61.  
  62. 4. Quick Start
  63.  
  64. 24U Appearance OSAX is really very easy to use. The best way to understand what it can do is to go through the included Sample Scripts. Simply run each of the applets, step by step, and examine their behaviour. When you are done, you can simply drag any of the applets and drop it onto the Script Editor's icon. The applet will open in an editing window so that you will see how it was created. You can even modify the code and test how your changes affect the applet's behaviour.
  65.  
  66.  
  67. 5. Troubleshooting
  68.  
  69. Before you contact our technical support regarding problems or difficulties using 24U Appearance OSAX, please check if your issue is not listed below:
  70.  
  71. • My floating message or progress indicator does not respond to mouse clicks.
  72. The floating windows can have problems getting mouse event when the script which opened them is just processing an Apple Event. This is a limitation of current version of 24U Appearance OSAX. There are two possible workaround for this issue. The first is to perform all your actions in a short idle event handler. The other one is to create another applet which you will use only for displaying the windows.
  73.  
  74. • I cannot use the buttons in a progress indicator, because they don't work.
  75. If you don't care about ability to move or collapse the progress indicator's window, please check the sample script called “command progress”. This script presents a simple workaround that can be enough in most cases.
  76.  
  77. • I cannot post notification more than once.
  78. You probably don't remove the previously posted notification. A new notification cannot be posted until the previous one is removed with the “remove notification” command.
  79.  
  80. • I can display a “better” dialog but I don't know how to get data from it?
  81. There is a sample script called “display better dialog” in the “Sample Scripts” folder. Open the script in your script editor, and you'll see couple of examples on how to gather data from different kinds of dialogs.
  82.  
  83.  
  84. If your problem is not listed above or if the recommended solution does not work for you, please contact our technical support by e-mail at <support@24u.cz>.
  85.  
  86.  
  87. 6. Shareware Notice
  88.  
  89. Please note that 24U Appearance OSAX is SHAREWARE. That means it is not free and you have to pay a licence fee if you want to keep it. You can install 24U Appearance OSAX and try it for the period of 14 days. After this period, 24U Appearance OSAX can stop working and require a registration code. We will provide you with your registration code after you pay for your licence.
  90.  
  91. You can freely distribute 24U Appearance OSAX as long as you distribute the original compacted archive untouched and you don't charge money for the distribution. If you want to distribute 24U Appearance OSAX on a physical medium, such as CD-ROM, or if you want to distribute it in other form than the original compacted archive, you should ask for our permission.
  92.  
  93. You can find detailed licence terms in the file named “Licence Agreement”.
  94.  
  95.  
  96. 7. Contact Information
  97.  
  98. You can contact us at one of the following addresses. We prefer contacting us via e-mail, but you can use any other method if e-mail is not good enough for you.
  99.  
  100. E-mail:       info@24u.cz          general information about our products and our company
  101.               eval@24u.cz          free evaluation codes registration
  102.               sales@24u.cz         paid licences ordering and registration
  103.               support@24u.cz       technical support and bug reports
  104.  
  105. WWW:          http://www.24u.cz/
  106.  
  107. Phone/fax:    +420-(0)2-9962423
  108.  
  109. Snail mail:   24U s.r.o.
  110.               Skochovicka 88
  111.               252 45  Zvole u Prahy
  112.               Czech Republic
  113.  
  114.  
  115. 8. Copyright
  116.  
  117. The software 24U Appearance OSAX is copyright © 2000-2001 24U s.r.o. All rights reserved.
  118.